home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_a2m / jmpst273 / jumpst2.asc < prev    next >
Encoding:
Text File  |  1995-05-02  |  13.3 KB  |  437 lines
  1.                         JumpSTART Version 2.7
  2.  
  3.                    by Paul Lefebvre (c) 1991, 1992
  4.            (Released on GEnie and Delphi on July 22, 1992)
  5.            
  6.                    
  7.      JumpSTART is a disk menuing system that will make your ST easier 
  8.   
  9. to use. An attractive dialog box is displayed with a list of your most 
  10.   
  11. commonly used programs (games, applications, etc).  These programs can 
  12.   
  13. be assigned descriptions of up to 20 characters in place of the normal 
  14.   
  15. ST filename and the list can contain up to 63 file descriptions, 21 on 
  16.   
  17. each page.
  18.   
  19.      JumpSTART runs in ST low, medium and high resolutions. The 
  20.   
  21. program will automatically detect which resolution it is in, load the 
  22.   
  23. correct JMP file list and display the appropriate dialog.  It also 
  24.   
  25. works with both floppy and hard drive based systems.  Any ST user with 
  26.   
  27. a little experience with the file selector will be able to set up 
  28.   
  29. JumpSTART so that anybody can quickly use the files they need.
  30.  
  31.   
  32.                          Setting Up JumpSTART
  33.  
  34.  
  35. Files in this LZH :
  36.  
  37.    CHANGES.DOC   Version history
  38.    JUMPST2.ASC   Instructions in ASCII format
  39.    JUMPST2.PRG   JumpSTART 2.7 program file
  40.    JUMPST2.RSC   JumpSTART multi-res resource file
  41.    JUMPST2.NIC   NeoDesk 3 Icons
  42.    STARTGEM.PRG  Auto folder program to load JumpSTART at boot up
  43.    STARTGEM.INF  Data file needed by STARTGEM.PRG
  44.  
  45.  
  46.                          Floppy Drive Systems
  47.                          
  48.  
  49.      Place a copy of JUMPST2.PRG, JUMPST2.RSC and STARTGEM.INF in the 
  50.   
  51. root directory of each disk that you want to have JumpSTARTed.  If you 
  52.   
  53. do not already have an AUTO folder on the disk, create one.  Place 
  54.   
  55. STARTGEM.PRG in the AUTO folder.  Preferably, all files to be 
  56.   
  57. JumpSTARTed should be kept in separate folders on the disk.
  58.   
  59.  
  60.                           Hard Drive Systems
  61.                           
  62.  
  63.      If you have a hard drive, I'll presume you do not need me to tell 
  64.   
  65. you how to set up things.   I'll just mention that JUMPST2.PRG and 
  66.   
  67. JUMPST2.RSC must be in the same directory.  I like to place all my JMP 
  68.   
  69. file lists in the same directory, but they can be placed anywhere.
  70.   
  71.  
  72.                            Using JumpSTART
  73.  
  74.                          
  75.      Set your system to medium or high resolution and double-click on 
  76.   
  77. JUMPST2.PRG.  (Although JumpSTART does work in low resolution, it will 
  78.   
  79. come up in RUN ONLY mode and will not allow any changes to be made to 
  80.   
  81. JMP file lists.)  You will now see the JumpSTART main dialog.  All the 
  82.   
  83. center 21 file description boxes will be blank.
  84.   
  85.  
  86.          (Add) Adding Files And Descriptions To The File List
  87.  
  88.  
  89.      Click on the button marked 'Add'.  A file selector will appear.  
  90.   
  91. This file selector is used to locate the program that you want 
  92.   
  93. JumpSTARTed.  (Consult your manual if you are unfamiliar with how the 
  94.   
  95. file selector operates.  I would recommend using an alternative file 
  96.   
  97. selector, such as UIS III)  Using the file selector, locate the 
  98.   
  99. program that you want to JumpSTART and when it is displayed in the 
  100.   
  101. 'Selection' line, click on OK.  If the program has a 'PRG', 'TOS', 
  102.   
  103. 'APP', or 'TTP' extender you will be presented with a new dialog box 
  104.   
  105. that will allow you to type in the description that will be used in 
  106.   
  107. place of the actual filename.  You may enter whatever you want as a 
  108.   
  109. description, using any character.  Click on OK to store it.
  110.   
  111.      The file selector will be redisplayed to allow you to continue 
  112.   
  113. adding programs to the file list.  Any time that you want to quit, 
  114.   
  115. just pick cancel from either the file selector or the file description 
  116.   
  117. dialogs.  When you pick cancel, the main dialog will be displayed with 
  118.   
  119. any files that have been added.  The descriptions for these files will 
  120.   
  121. be displayed in the 21 file description boxes.  The descriptions are 
  122.   
  123. automatically sorted if the Sort button is selected.
  124.  
  125.      Special Note : If you select a file that does not end in one of 
  126.   
  127. the previously specified extenders, JumpSTART will do an 'Install 
  128.   
  129. Application'.  A new file selector will appear and you are required to 
  130.   
  131. select a file that ends in 'PRG', 'TOS', 'TTP', or 'APP'.  Now you may 
  132.   
  133. enter a description as previously described.  Ex. To add MRELIZA.BAS, 
  134.   
  135. select it from the file selector.  At the new file selector, select 
  136.   
  137. GFABASRO.PRG (this file is required to execute GFA BASIC programs).  
  138.   
  139. Now give MRELIZA.BAS a description (Mr. Eliza).  When you click on Mr. 
  140.   
  141. Eliza in the main dialog, it will automatically load GFABASRO.PRG and 
  142.   
  143. tell it to run MRELIZA.BAS!
  144.   
  145.  
  146.                     Instant-Loading JMP File Lists
  147.  
  148.  
  149.      When adding a file, if the extender is JMP, then you will be 
  150.   
  151. immediately prompted for a description.  After a description is 
  152.   
  153. entered, everything will be added to the file list as usual, but when 
  154.   
  155. you click on this description, the JMP file list it refers to will be 
  156.   
  157. instantly loaded into memory, replacing the one that was there.
  158.   
  159.      Notice the 'close' button at the top left of the file 
  160.   
  161. description boxes.  This is similar to the desktop 'close window' 
  162.   
  163. button.  Every JMP file list that is loaded (Instant-Load or with the 
  164.   
  165. Load button) has its pathname memorized.  To return to the previously 
  166.   
  167. displayed JMP file list, click on the 'close' button.  The previous 
  168.   
  169. file list will then be reloaded.  Up to 10 JMP file lists can be 
  170.   
  171. stored in this manner.  This feature will be of limited use to floppy 
  172.   
  173. drive users, but is incredibly useful for hard drive users.
  174.  
  175.  
  176.                    Changing The File List Description
  177.  
  178.                   
  179.        Click on the box at the bottom of the screen marked 'JumpSTART 
  180.   
  181. Disk Title'.  This box will allow you to enter a title for the current 
  182.   
  183. file list.
  184.   
  185.   
  186.                      (Save) Saving The File List
  187.  
  188.  
  189.      Select the button on the right marked 'Save'.  A file selector 
  190.   
  191. will appear to allow you to name the file.  The file selector will 
  192.   
  193. always open to the directory from which JumpSTART was loaded.  To make 
  194.   
  195. it auto-load, it must be in the same directory as JUMPST2.PRG and have 
  196.   
  197. a specific name :
  198.   
  199.      STARTHI.JMP  -  auto-load for high resolution
  200.      STARTMED.JMP -  auto-load for medium resolution
  201.      STARTLOW.JMP -  auto-load for low resolution
  202.  
  203.      Make sure the correct filename is shown in the selection line and 
  204.   
  205. select OK.
  206.   
  207.  
  208.                      Changing To A Different Page
  209.                      
  210.  
  211.      If you have a file list with more than 21 descriptions, the box 
  212.   
  213. on the lower left corner will change to say 'Page 1 of 2' (with more 
  214.   
  215. than 42 it will say 'Page 1 of 3').  To change the page, click on the 
  216.   
  217. up arrow to go up a page, and the down arrow to go down a page.
  218.  
  219.  
  220.                      (Load) Using The Load Button
  221.  
  222.  
  223.      Select 'Load' from the right side of the dialog.  The file 
  224.   
  225. selector will show all the files in the current directory.  
  226.   
  227. -    If you select a file that has an extender of '.JMP', then the 
  228.   
  229.      file list will be loaded and displayed.
  230.  
  231. -    If you select a file that has an extender of '.PRG', '.APP', 
  232.   
  233.      '.TOS', or '.TTP', then the program will be run as if it had been 
  234.   
  235.      installed as a button in the file list.
  236.  
  237. -    If you select a file with an unspecified extender, then JumpSTART 
  238.   
  239.      will use a new feature to pass this file to your favorite text 
  240.      
  241.      file viewer.  To do this, create a file with the name 
  242.      
  243.      'JUMPST2.DAT' and on the first line of this file type the 
  244.      
  245.      pathname (in capital letters) of your favorite text file viewer.  
  246.   
  247.      Place this file in same folder as JUMPST2.PRG.  You do not have 
  248.   
  249.      to use this feature.  If the JUMPST2.DAT file does not exist, 
  250.   
  251.      then JumpSTART will simply not do anything if a file with an 
  252.   
  253.      unspecified extender is selected.
  254.  
  255.      
  256.                   (Re-Read) Using The Re-Read Button
  257.  
  258.  
  259.      The re-read button will re-load the first JMP file loaded by 
  260.   
  261. JumpSTART.  If the re-read was successful, then the memorized 
  262.   
  263. file lists are cleared.  Useful for floppy disk owners as it allows 
  264.   
  265. them to swap disks and press this button to load the JMP file list 
  266.   
  267. from the new disk.
  268.   
  269.  
  270.             (Clear) Clearing The JMP File List From Memory
  271.  
  272.  
  273.      Pressing clear will instantly clear the current JMP file list 
  274.   
  275. from memory.  There is no warning, so use with caution!  This does not 
  276.   
  277. clear the file list on disk.  To make any changes permanent, select 
  278.   
  279. 'Save'.
  280.   
  281.  
  282.                (Run) Running A File From The File List
  283.  
  284.  
  285.      Select the button marked 'Run' and click once on the description.  
  286.   
  287. The file description will be displayed at the top of the screen while 
  288.   
  289. the program is loading. 
  290.   
  291.  
  292.           (Remove) Removing A Description From The File List
  293.  
  294.  
  295.      Select the button marked 'Remove'.  Each time you click on a 
  296.   
  297. description, it is removed from the screen and erased from the file 
  298.   
  299. list in memory.  It does not change the file list on disk or remove 
  300.   
  301. the actual file from the disk.  To make the changes permanent, select 
  302.   
  303. 'Save'.
  304.  
  305.  
  306.       (New Description) Changing A Description In The File List
  307.  
  308.  
  309.      Select 'New Description'.  Now click on the description that is 
  310.   
  311. to be changed.  The familiar 'New Description' dialog will appear, 
  312.   
  313. displaying the actual filename and current description and allow you 
  314.   
  315. to change the description.  If a description is changed and the 'Sort' 
  316.   
  317. button is selected, then the list will be resorted.  Be sure to 'Save' 
  318.   
  319. any changes.
  320.  
  321.  
  322.     (New Path) Changing The Path Of A Description In The File List
  323.  
  324.  
  325.      Select 'New Path' and click on the description of the file to 
  326.   
  327. change.  A dialog will appear showing the description's complete 
  328.   
  329. pathname.  If you wish to change it, select 'Change'.  With the file 
  330.   
  331. selector, locate the new path and program to associate with the 
  332.   
  333. description, then click on OK.  Be sure to 'Save' any changes.
  334.  
  335.  
  336.                      (Sort) Using the Sort Button
  337.  
  338.  
  339.      Select the sort button if you want the file list to be sorted.  
  340.   
  341. De-select for an unsorted list.  The sort setting is saved to the JMP 
  342.   
  343. file so that the next time it is loaded it will be set automatically.  
  344.   
  345. This will allow you to have some JMP files that are sorted and some 
  346.   
  347. that are not and not worry about the status of the sort button.
  348.  
  349.   
  350.                          (Help) Getting Help
  351.  
  352.  
  353.      Select the button marked 'Help' in the top right corner of the 
  354.   
  355. dialog.
  356.  
  357.  
  358.                 (Use DA's) Accessing Desk Accessories
  359.  
  360.  
  361.      Select the button marked 'Use DA's' in the upper left corner of 
  362.   
  363. the dialog.  The screen will be cleared and the 'Desk' menu at the top 
  364.   
  365. left will allow access to desk accessories.  To return to JumpSTART, 
  366.   
  367. select 'Return to JumpSTART' from the 'Desk' menu.  Be sure to close 
  368.   
  369. all accessories before returning to JumpSTART or problems could occur.
  370.   
  371.  
  372.                       (Quit) Quitting JumpSTART
  373.  
  374.  
  375.      Selecting 'Quit' immediately exits back to the calling program.
  376.   
  377.  
  378.                 JumpSTART As An Installed Application
  379.  
  380.  
  381.      From the desktop, click on JUMPST2.PRG, select 'Install 
  382.   
  383. Application' from the 'Options' menu.  Type 'JMP' as the extender 
  384.   
  385. click on install.  Be sure to 'Save Desktop' to make the changes 
  386.   
  387. permanent.  Now when you double-click on a JMP file list, it will 
  388.   
  389. override the auto-load filename for the current resolution.
  390.   
  391.  
  392. Note For TOS 1.4 Or Higher : DO NOT USE STARTGEM.PRG, instead install 
  393.   
  394. JUMPST2.PRG as an auto application.
  395.   
  396.  
  397.                             Closing Notes                            
  398.  
  399.  
  400.      This program is freeware, but I do require that if you use it, 
  401.   
  402. you MUST send me a note (via EMail, or U.S. mail) telling me.  If 
  403.   
  404. you're notifying me via U.S. mail, please let me know how you acquired
  405.   
  406. JumpSTART.  That's not too much to ask, is it?
  407.   
  408.      Distribute JumpSTART anywhere you can, but keep this LZH intact.  
  409.   
  410. For comments, questions, or suggestions I can be reached at :
  411.   
  412. Paul Lefebvre                      GEnie mail address : P.LEFEBVRE
  413. 94 Bailey Avenue                   Delphi mail address : PLEFEBVRE
  414. Lewiston, ME 04240
  415.  
  416. Special thanks to Jinfu Chen and Phillip R. Poulos for their PASCALM 
  417.   
  418. source code.  It has several routines which I found useful, including 
  419.   
  420. the LineA show mouse routine.
  421.  
  422. Additional special thanks to the following people who have responded 
  423.   
  424. or given suggestions :
  425.   
  426. Mark Slagell (Very helpful in locating bugs before version 2.5)
  427. Michael Everhart (Requested allowing JumpSTART to unload from memory.
  428.                   I haven't got around to this, but if more people
  429.                   request it, I'll add it.)
  430. Ronald King (Encouragement)
  431. Neil Harding (Suggested allowing uninstalled programs to be loaded)
  432. Kent Cavaghan (Including JumpSTART in Oak Springs catalog)
  433. Allen Fasoldt (Inadvertently suggested optional file sorting)
  434. Larry Lefebvre (Made too many suggestions to list, Helped with bug 
  435.                testing)
  436. Ken Brick (Reminded me of TOS 1.4 autoloading procedure)
  437.